Document major differences between old and new review UI Change-Id: Id378dc187402ea5cb0ac9b25fc2805b108382207 Signed-off-by: Edwin Kempin <edwin.kempin@sap.com>
diff --git a/Documentation/user-review-ui.txt b/Documentation/user-review-ui.txt index 6bf46a9..62f569d 100644 --- a/Documentation/user-review-ui.txt +++ b/Documentation/user-review-ui.txt
@@ -1059,6 +1059,31 @@ In addition, Vim-like commands can be used to link:#key-navigation[ navigate] and link:#search[search] within a patch file. +[[new-vs-old]] +== New Review UI vs. Old Review UI + +There are some important conceptual differences between the old and +new review UIs: + +- The old change screen directly shows all patch sets of the change. + With the new change screen only a single patch set is displayed; + users can switch between the patch sets by choosing another patch + set from the link:#patch-sets[Patch Sets] drop down panel in the + screen header. +- On the old side-by-side diff screen, new comments are inserted by + double-clicking on a line. With the new side-by-side diff screen + double-click is used to select a word for commenting on it; there + are link:#add-inline-comment[several ways to insert new comments], + e.g. by selecting a code block and clicking on the popup comment + icon. + +Limitations of the new review UI: + +- The new side-by-side diff screen cannot render images. + +Users preferring the old review UI can link:#old-change-screen[ +configure the change view] in their preferences. + GERRIT ------ Part of link:index.html[Gerrit Code Review]
